home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / sk_j1202.arc / SUPERK.DOC < prev   
Text File  |  1989-12-23  |  59KB  |  1,205 lines
  1. SuperK v4.47  MiniNet's External Protocol Driver including
  2. JBatch        MiniNet's Driver for Richard B. Johnson's Jmodem Protocol
  3.  
  4. Protocols Supported: Xmodem Checksum      Xmodem CRC      Ymodem (1k Xmodem)
  5.                      Jmodem               Cmodem          WXmodem
  6.                      K9Xmodem             Super8K         Super8K-G MNP
  7.  
  8.           Full Batch  or  Single File Mode  -  No, Auto or Prompt Resume.
  9.  
  10. SuperK is Copyright 12/4/1986, 1989 and JBatch is Copyright 11/01/1988, 1989
  11. by Crater Rim Software. All Rights Reserved.
  12.  
  13. = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  14.  
  15. SuperK Licensing Agreement
  16. --------------------------
  17.    For the sake of clarity,  all references and restrictions to the use  of 
  18.    the  SuperK  also apply to all of the associated support files INCLUDING 
  19.    the K9Xmodem, Super8K and Jbatch protocols. 
  20.  
  21.    SuperK,  its  overlays  and  all of its associated support files are not
  22.    public domain software, nor are they free software.  SuperK is copyright
  23.    (c) 1985,  1989 - the K9Xmodem,  Super8K,  Super8K-G,  SuperK and JBatch
  24.    protocols  are copyright (c) 1987,  1989 by Crater Rim Software with All
  25.    Rights Reserved by Crater Rim Software.
  26.  
  27.    NON-REGISTERED USERS ARE GRANTED A LIMITED LICENSE TO USE SuperK VERSION 
  28.    4.xx ON A TRIAL BASIS FOR  THE  PURPOSE  OF  DETERMINING  WHETHER  THESE 
  29.    PROGRAMS ARE SUITABLE FOR THEIR NEEDS.  THE TERM OF THIS LIMITED LICENSE 
  30.    IS 30 DAYS.  USE OF SuperK,  EXCEPT FOR THIS LIMITED  PURPOSE,  REQUIRES
  31.    REGISTRATION.  EXTENDED  USE  OF  NON-REGISTERED COPIES OF SuperK BY ANY
  32.    PERSON,  BUSINESS,  CORPORATION,  GOVERNMENTAL AGENCY OR OTHER ENTITY IS
  33.    STRICTLY FORBIDDEN.
  34.  
  35.    Registration permits you to use SuperK on a regular basis  on  a  single 
  36.    computer.  A  registered  user  may  use  the  program  on  a  different 
  37.    computer,  but may not use the program on more than one computer at  the 
  38.    same time.
  39.  
  40.    MULTIPLE NODE BBSes WHICH OPERATE IN A NETWORKING  ENVIRONMENT  BUT  ARE 
  41.    USING  ONE COPY OF SUPERK ARE CONSIDERED TO BE USING MULTIPLE COPIES AND 
  42.    REQUIRE A REGISTRATION FOR EACH BBS NODE. 
  43.  
  44.    Registration also includes priority support on Underdog's  MiniNet  BBS.  
  45.    Users  need  register only one version of SuperK.  Registration includes 
  46.    licensed use of all upgrades.  
  47.  
  48.    All corporate,  business,  government or other commercial uses of SuperK 
  49.    must be registered.  We offer quantity discounts and Corporate  or  site 
  50.    licensing is also available.  
  51.  
  52.    No  user  may  modify  SuperK  in any way,  including but not limited to 
  53.    decompiling, disassembling or otherwise reverse engineering the program.  
  54.  
  55.    All users are granted a limited license to copy SuperK version 4.xx only 
  56.    for  the trial use of others subject to the above limitations,  and also 
  57.    the following: 
  58.  
  59.          SuperK  version  4.xx  must  be  copied  in unmodified form, 
  60.          complete with the file containing this license information.  
  61.  
  62.          Any and all SuperK documentation must be included  with  the 
  63.          copy.  No fee,  charge or other compensation may be accepted 
  64.          or requested by any licensee.  
  65.  
  66.          SuperK may not be distributed in conjunction with any  other 
  67.          product without prior arrangements with Crater Rim Software. 
  68.  
  69.    Operators  of electronic bulletin board systems (Sysops) may post SuperK 
  70.    version 4.xx for downloading by their users only as long  as  the  above 
  71.    conditions are met.  
  72.  
  73.    Distributors of public domain or user supported software may  distribute
  74.    copies of SuperK version 4.xx subject to the above conditions ONLY AFTER
  75.    OBTAINING  WRITTEN PERMISSION FROM Crater Rim Software.  Please write or
  76.    call for details.  
  77.  
  78.                   ShareWare Software Discalaimer and Warranty
  79.  
  80.    Crater  Rim Software makes no warranty of any kind,  express or implied, 
  81.    including without limitation,  any warranties of merchantability  and/or 
  82.    fitness  for  a  particular  purpose.  Crater  Rim Software shall not be 
  83.    liable  for  any  damages,   whether  direct,   indirect,   special   or 
  84.    consequential  arising  from a failure of this program to operate in the 
  85.    manner desired by the user.  Crater Rim Software shall not be liable for 
  86.    any damage  to  data  or  property  which  may  be  caused  directly  or 
  87.    indirectly by use of the program.  
  88.  
  89.    IN  NO  EVENT WILL Crater Rim Software BE LIABLE TO YOU FOR ANY DAMAGES, 
  90.    INCLUDING  ANY  LOST  PROFITS,  LOST  SAVINGS  OR  OTHER  INCIDENTAL  OR 
  91.    CONSEQUENTIAL  DAMAGES  ARISING  OUT OF YOUR USE OR INABILITY TO USE THE 
  92.    PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY.  
  93.  
  94.    See the Ordering section for more information on registration, corporate 
  95.    licensing and similar topics.  
  96.  
  97.    WARNING:  YOU MAY NOT USE ANY VERSION OF SuperK ON A REGULAR BASIS
  98.              WITHOUT REGISTERING THE PACKAGE. 
  99.  
  100. = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  101. SuperK External Protocol Driver - Revision Log
  102.  
  103. V2.50  - Dated 08/22/88  Initial Release
  104. V2.52  - Dated 09/01/88
  105. V3.10  - Dated 11/05/88
  106. V3.12  - Dated 12/04/88
  107. V3.13  - Dated 12/06/88
  108. V3.14  - Dated 12/27/88
  109. V3.15  - Dated 01/07/89
  110. V3.16  - Dated 01/26/89
  111. V4.00  - Dated 02/20/89
  112. V4.10  - Dated 03/29/89  Changes
  113.  
  114.    Modem Buffer size has been increased from 4K to 8K
  115.  
  116.    It has been brought to my attention that the latest MS  Basic  compilers 
  117.    drop the RTS line when performing a DOS shell. SuperK now checks the RTS 
  118.    line upon startup and will raise it if it has been dropped. 
  119.  
  120.    The  addition  of a Work Path so that SuperK can easily access Read Only 
  121.    files in a networking envirnment (see W - Work Path below). 
  122.  
  123.    Corrected a bug in the Overwrite check.  Under certain circumstances, an 
  124.    I/O error would occur if too many files were rejected by the receiver.
  125.  
  126. V4.11  - Dated 04/05/89  Corrected a minor bug in the ReadOnly copy routine
  127.  
  128. V4.12  - Dated 05/04/89  Changes
  129.  
  130.    Reworked the Super8K Error Recovery routines.
  131.  
  132.    There have been a number of users having problems with SuperK  reporting
  133.    a run time error of F0=xxxx.  This is due to the fact that SuperK cannot
  134.    find its overlay file, SUPERK.000. Seems there are some (antiquated) BBS
  135.    packages  that change directories before transferring a file!  When this
  136.    happens,  SuperK is unable to find its overalay (or the  SKA.COM  jmodem
  137.    module for that matter).  If this is happening to you,  be sure to start
  138.    up SuperK as   SUPERK @   and define  OVL Path  parameter  to  the  FULL
  139.    drive:\path\  where SUPERK resides.
  140.  
  141.    There are also reports that some BBS software is unable  to  "read"  the 
  142.    SuperK errorlevel returned upon exit. This is a problem with the calling 
  143.    program  NOT  with SuperK as the errorlevel returned is fully recognized 
  144.    by DOS via a batch file. 
  145.  
  146. V4.20  - Dated 06/25/89  Changes - see documentation below
  147.  
  148.    Added support for Com ports 3 and 4.
  149.    Added support for 38400, 57600 and 115200 bps.
  150.    Added L command line parameter to let SuperK know that the port is locked
  151.    Added C command line parameter to enable CTS checking for locked ports
  152.    Added U command line parameter to allow the passage of actual modem speed
  153.            when port is locked
  154.    Added Quick Escape from the SuperK help screen(s). Simply press the [Esc]
  155.            key and you will be returned to DOS with an errorlevel of 1.
  156.  
  157. V4.30  - Dated 06/28/89  Changes - see documentation below
  158.  
  159.    Added a new protocol! MNP Super8K-G in single or batch mode!
  160.  
  161. V4.31  - Dated 07/04/89  Changes
  162.  
  163.    Changed the way in which the transfer times are calculated...  This  has 
  164.    no effect on the cps calculations, just the estimated transfer time. 
  165.  
  166.    Changed  the  Main  transfer log file format to conform with the DSZ log
  167.    file in that, if the transfer fails, the first character of the log file
  168.    line will be an  E  rather than an  R  or  S.
  169.  
  170. V4.40  - Dated 07/28/89  Changes
  171.  
  172.    There  have  been some reports of the Super8K protocols hanging when the 
  173.    locked port parameter  is  used.  Although  I  have  not  been  able  to 
  174.    duplicate the problem,  I have modified the CTS checking and doubled the 
  175.    timeout limit in the hopes that this will solve the problem.  I've  also 
  176.    added  a  short  delay  before  returning to the batch mode receive Sync 
  177.    window so that the sender has enough time to clear its buffer.
  178.  
  179.    The Jmodem driver, SKA.COM has been upgraded to the equivilant of Jmodem
  180.    v1.20.  This should clear up the intermittant transfer result  reporting 
  181.    of  the earlier SKA.COM version.  On the same note,  the Jmodem transfer 
  182.    status window has been modified so the it  resembles  the  other  SuperK 
  183.    protocols. 
  184.  
  185.    This  version  implements  a  Resume  mode  for K9Xmodem,  Super8K-G and 
  186.    Super8K and ALL batch  mode  transfers  except  for  Jmodem  Batch!  The 
  187.    Resume  mode  is  set  via  the  SuperK  @ configuration and supports an 
  188.    inactive and 2 active states. 
  189.  
  190.    Here's how it works...
  191.  
  192.        Within  the SUPERK @ configuration section,  the J option will cycle 
  193.        through the 3 states of Resume mode: 
  194.  
  195.        No     =  normal operation with overwrite flag in control of how
  196.                  duplicate filenames are handled.   Command Line Equals R0
  197.  
  198.        Auto   =  automatic  resume  if  and only if the receiver's file is 
  199.                  smaller than the sender's file AND  the  receiver's  file 
  200.                  size  is  some multiple of 8K (SuperK default block write 
  201.                  size).                             Command Line Equals R1
  202.  
  203.        Prompt =  if duplicate file is found, SuperK will prompt for resume
  204.                  instructions.                      Command Line Equals R2
  205.                  
  206.                  Your options are:
  207.  
  208.                  Resume Y
  209.                     Pressing Y (or any other key) commences the  resumption
  210.                     of  the transfer,  appending the new data to the end of
  211.                     the receiver's file.
  212.  
  213.                  Resume N 
  214.                     Pressing N cancels the receipt of the file and moves on
  215.                     to  the  next  file if using any batch protocol - or to
  216.                     DOS if using Super8K/Super8K-G single file mode  (Other
  217.                     Single file protocols do not support Resume).
  218.  
  219.                  Start Over
  220.                     Pressing  S  will  inform SuperK that you wish to start
  221.                     this transfer anew.  SuperK will erase  the  receiver's
  222.                     existant  file  and  request that the sender start from
  223.                     the beginning of the file.
  224.  
  225.                  Please note that the Prompt mode is on a timer  loop  that
  226.                  will  timeout  in  about  15 seconds.  If no user input is
  227.                  received  before  timing  out,   SuperK  will  default  to
  228.                  whatever  the  default  Overwrite  flag  is  set to...
  229.  
  230.                  Overwrite set to Yes = start transfer from from  0  bytes
  231.                  Overwrite set to No  = cancel the transfer
  232.  
  233.        The command line will also accept an  R#   where # = 0, 1 or 2  (see
  234.        definitions  above) as part of the protocol prompt.  If the optional 
  235.        R#  parameter is specified,  SuperK  will  force  the  preconfigured
  236.        Resume  mode  to  whatever  state  you specify for that transfer set 
  237.        (batch or single) only.
  238.  
  239.        Example: 
  240.  
  241.           You have the resume flag set to No via SUPERK  @  and  want  to 
  242.           perform a Super8K batch receive.  The normal direction protocol 
  243.           parameter  would  be  RSB  however,  you  want SuperK to Prompt 
  244.           Resume on this transfer. 
  245.  
  246.           The  Prompt  Resume  Mode  may  be  activated  by  making  your 
  247.           direction protocol command line parameter read    RSBR2
  248.  
  249.        Since all of the SuperK protocols have a default 8K block write  and 
  250.        each  8K  block  has been CRC accepted before being written to disk, 
  251.        there isn't any CRC check made on ANY resumed transfer. Again, 
  252.    
  253.          NO CRC CHECKS ARE MADE ON THE EXISTANT PORTION OF A RESUMED FILE.
  254.  
  255.        On the same  token,  files  that  are  less  than  8K  in  size  are 
  256.        automatically  resent  in  their  entirety and an active resume mode 
  257.        overrides the Overwrite flag setting. 
  258.  
  259.        In summary...  with the Resume mode active, the receiving side waits 
  260.        for  the  filesize  from  then  sending  side and then checks for an 
  261.        already existant file.  If a file exists and the size is  less  than 
  262.        the  filesize  sent  by the sender and the existant file is an exact 
  263.        multiple of 8K, SuperK will resume the transfer.  If the size of the 
  264.        existant  file  is equal to or greater than the filesize sent by the 
  265.        sender,  the receiver will refuse the file and move on to  the  next 
  266.        file (if in batch mode). 
  267.  
  268.        And lastly...  until this new version  gets  circulated  around,  be 
  269.        aware  that if you are "talking" to a previous version of SuperK the 
  270.        resume feature  will  automatically  abort  the  transfer.  If  this 
  271.        happens, drop to DOS and reconfigure SuperK with the Resume Mode set 
  272.        to  No  (or  call  SuperK  with  a direction protocol parameter that 
  273.        includes R0). 
  274.  
  275.    Added seperate WXmodem Transfer window color. The color difference makes
  276.    it easier to distiguish between Xmodem and WXmodem transfers.
  277.  
  278.  * Due to the sluggish response of users to register the program,  I've had 
  279.    to add a sharware screen with 10 second delay to act as an incentive  to 
  280.    register...   and   since  this  version  represents  a  MAJOR  revision 
  281.    (requiring MAJOR rework and time),  the registration fee has been raised
  282.    to $25.00.
  283.    
  284.    I WILL CONTINUE TO ACCEPT  $20.00  REGISTRATIONS FOR THIS VERSION OR ANY
  285.    EARLIER VERSION UNTIL SEPTEMBER 10, 1989 AT WHICH TIME REGISTRATION WILL
  286.    GO TO THE NEW $25.00 FEE.
  287.  
  288.    Users  who  have  already registered earlier versions are NOT subject to 
  289.    the registration fee change and may download their  registered  versions 
  290.    directly from Underdog's MiniNet at (206) 725-9233   1200/2400/9600 HST. 
  291.  
  292.    Registration  gets  you  the latest version WITHOUT the Shareware screen 
  293.    and delay,  the latest registered version on disk or via  download  from 
  294.    MiniNet,  1  year  SuperK support and access to all future updates (both
  295.    registered and non-registered) via MiniNet!
  296.  
  297. V4.45  - Dated 10/22/89  Changes
  298.  
  299.    SuperK now supports Cmodem in single or  batch  mode!  This  brings  the
  300.    protocol  count to 18 in all!!!  Please note that the current version of
  301.    Cmodem  does not support locked ports and/or subdirectories.  I can't do
  302.    anything about the locked ports but have  made  facility  in  SuperK  to
  303.    change  drives and/or directories when performing Cmodem transfers.  The
  304.    command line protocol designator for Cmodem transfers is H in  the  form
  305.    (RH,  SH, RHB or SHB).  Since Cmodem has its own resume features, I have
  306.    linked the SuperK resume mode to Cmodem - that is,  a SuperK resume mode
  307.    of  No  disables  Cmodem  resume  - any other SuperK resume mode enables
  308.    Cmodem resume.
  309.  
  310.    This version also eliminates the need for the use of COMMAND.COM when it
  311.    performs  its  shell  to  the external Cmodem and Jmodem modules.  This,
  312.    along  with  some  code  modification  should   reduce   SuperK   memory
  313.    requirements considerably!
  314.  
  315.    The Jmodem module (old SKA.COM) has been modified and renamed to SKJ.COM
  316.    and, since COMMAND.COM is no longer used to perform internal DOS shells,
  317.    SuperK has been "educated" to read the DOS error levels returned by  SKJ
  318.    and Cmodem,  thus eliminating the need for multiple copies of the Jmodem
  319.    module when using SuperK in a multinode BBS environment.
  320.  
  321. V4.46  - Dated 11/19/89  Change
  322.  
  323.    This version is dedicated to Howard Ross for the time (and  frustration)
  324.    he  invested  trying  to locate a bug in the Jmodem Batch mode routines!
  325.    Thanks to his feedback, the bug has been found and exterminated!
  326.  
  327. V4.47  - Dated 12/05/89  Changes
  328.  
  329.    This version is dedicated to Joseph Sheppard who was having difficulties
  330.    with the Log and Xfer filenames!  I have added several new command  line
  331.    parameters:
  332.  
  333.      X - This parameter is used in conjunction with an alternate Xfer  file
  334.          name.  The  filename  supplied  here  will  override  the  default
  335.          XferFile name setting. Specify as:  Xspecial.txt
  336.  
  337.      L - Not a new parameter but an additional usage.  When used alone,  it
  338.          still  denotes  a  locked  port.  When used in conjunction with an
  339.          alternate Log file name,  the filename supplied here will override
  340.          the default Logfile name setting.  Specify as:  Lspecial.log
  341.  
  342.      W - This  parameter  is  used  in  conjunction  with an alternate Work
  343.          Directory.  The path supplied here will override the default  Work
  344.          Directory setting. Specify as:  WC:\SPECIAL\AREA\
  345.  
  346.      V - This parameter triggers the verbose display of the current default
  347.          settings.  It may be used for debug purposes during initial SuperK
  348.          setup or during normal operations to display all  of  the  current
  349.          SuperK  settings.  If startup is aborted and the V parameter is in
  350.          effect,  SuperK will replace the  normal  help  screens  with  the
  351.          verbose settings list.  NOTE: This option is only available in the
  352.          registered version.
  353.  
  354.    In addition,  I've made facility to place all of the SuperK command line
  355.    parameters  (except for the direction/protocol,  F and filespec(s)) into
  356.    your DOS environment via the  DOS  SET SUPERK=  command.  Upon  startup,
  357.    SuperK  will check the DOS environment for the  SUPERK=  set.  If found,
  358.    SuperK will parse this line FIRST.  SuperK then checks the command  line
  359.    and parses that line.  What this means is that any duplicate settings on
  360.    the SuperK command line will override any of the same settings  in  your
  361.    DOS environment. This (should) give you total control over how SuperK is
  362.    implemented each time it is called!
  363.  
  364.    Example: add the following line to you AUTOEXEC.BAT (or SuperK calling
  365.             batch file)
  366.  
  367.               SET SUPERK=P1 S19200 L C V   
  368.  
  369.                          ^  ^      ^ ^ ^
  370.                          |  |      | | +- verbose mode
  371.                          |  |      | +--- Monitor CTS
  372.                          |  |      +----- Port Locked
  373.                          |  +------------ Port Speed 19200bps
  374.                          +--------------- Comm Port 1
  375.  
  376.             Your SuperK command line only requires:
  377.  
  378.               SUPERK rsb
  379.  
  380.                      ^^^
  381.                      ||+----- Batch Mode
  382.                      |+------ Super8K Protocol
  383.                      +------- Receive
  384.  
  385.             OR
  386.  
  387.               SUPERK rsb f c:\dls
  388.  
  389.                      ^^^ ^ ^
  390.                      ||| | +- Download Path
  391.                      ||| +--- Filespecs follow
  392.                      ||+----- Batch Mode
  393.                      |+------ Super8K Protocol
  394.                      +------- Receive
  395.  
  396.  
  397. NOTICE: The next major release v5.0 will (hopefully) be compiled  with  the
  398.         new  Turbo Pascal v5.5 compiler and will (hopefully) include Zmodem
  399.         and autostart options for all 20 protocols!
  400.  
  401.         Since the next version represents a MAJOR revision (requiring MAJOR
  402.         rework and time), the registration fee will be raised to $30.00.
  403.    
  404.         I WILL CONTINUE TO ACCEPT $25.00 REGISTRATIONS UNTIL THE NEW SuperK
  405.         v5.0 IS RELEASED - AT WHICH TIME REGISTRATION WILL GO TO $30.00.
  406.  
  407.         Users who have already registered  earlier  versions  will  NOT  be
  408.         subject  to  the  registration  fee  change  and may download their
  409.         registered versions directly from Underdog's MiniNet 1200/2400/9600
  410.         HST at  (206) 725-9233
  411.  
  412.         Registration  gets  you  the  latest  version WITHOUT the Shareware
  413.         screen and delay,  the latest registered version  on  disk  or  via
  414.         download  from MiniNet,  1 year SuperK support and access to future
  415.         registered version updates via MiniNet!
  416.  
  417. Memory requirements:
  418. ~~~~~~~~~~~~~~~~~~~   
  419.    Jmodem and Cmodem transfers require a minimum of 128K  (128,000  bytes).  
  420.    All of the other protocols only require about 70K (71,680 bytes). If you 
  421.    don't know how much memory you have available,  it can be checked easily 
  422.    as follows: 
  423.  
  424.    1)  Copy  DOS' CHKDSK.COM  to your comm directory.
  425.  
  426.    2)  Start up your comm program and execute the comm program's DOS  shell 
  427.        option. 
  428.  
  429.    3)  Type  CHKDSK  at the DOS prompt
  430.  
  431.    4)  CHKDSK  will display its results along with the "bytes free" figure. 
  432.        In order to perform Jmodem transfers,  the "bytes free" must  be  at 
  433.        least 128,000 (if you intend on using SuperK's Jmodem or Cmodem).
  434.  
  435.    5)  Enter "EXIT" at the DOS prompt.
  436.  
  437.    6)  Exit your comm program...
  438.  
  439. Command Line Syntax:
  440. ~~~~~~~~~~~~~~~~~~~
  441.  SuperK Px Sbaud [Ubaud] [Nx] [C] [L] [M] [R] [E] Dprotocol{byr#} F fspec fspec
  442.  
  443. Command line parameters :
  444. ~~~~~~~~~~~~~~~~~~~~~~~
  445.    Px  - Comm Port to use.
  446.  
  447.        Where x = 1, 2, 3 or 4
  448.  
  449.        The port addresses and IRQ's are standard IBM/MSDOS values:
  450.  
  451.                          Address     IRQ
  452.                          -------     ---
  453.                Com 1 =   03F8 hex     4
  454.                Com 2 =   02F8 hex     3
  455.                Com 3 =   03E8 hex     4
  456.                Com 4 =   02E8 hex     3
  457.  
  458.        Please  note:
  459.           Com3 and Com4 may not work on your system.  Be sure to check your 
  460.           Async Card manual to be sure that your port addresses  and  IRQ's 
  461.           are the same... 
  462.  
  463.    Sbaud - Port Speed.
  464.  
  465.        Where baud = 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200
  466.  
  467.              S300     =     300 bps      S9600    =    9600 bps
  468.              S1200    =    1200 bps      S19200   =   19200 bps
  469.              S2400    =    2400 bps      S38400   =   38400 bps
  470.              S4800    =    4800 bps      S57600   =   57600 bps
  471.                             S115200  =  115200 bps
  472.  
  473.        This  is  the  speed  at  which  the  comm  port  is  set at and not 
  474.        necessarily the speed of the modem (if the port is locked that is). 
  475.  
  476.        Please  note:
  477.  
  478.          The 57600bps and 115200bps speeds,  although feasible,  require  a 
  479.          high  speed  Async  Card  with  an  NS16550 UART and have not been 
  480.          tested (mine is one of those non-workable systems)... 
  481.  
  482.    Ubaud - Modem Speed.
  483.  
  484.        Where baud = 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200
  485.  
  486.        This is the actual speed (according to the connection) of the modem.
  487.  
  488.        The inclusion of the U parameter is purely optional and if  present, 
  489.        will  be  used  to  accurately  calculate  the  transfer  times  and 
  490.        accurately report the correct baud rate in the  Transfer  Log  file.  
  491.        If  it  is  not  specified,  SuperK  will set its value equal to the 
  492.        actual port speed as specified via the S parameter. 
  493.  
  494.    DirectionProtocol[b][y][r#]
  495.  
  496.        Direction of transfer. Where D = R (receive) or S (send)
  497.           and Protocol  X = Xmodem                 C = CRC Xmodem
  498.                         Y = Ymodem (1k Xmodem)     W = WXmodem
  499.                         J = Jmodem                 H = Cmodem
  500.                         K = K9Xmodem               S = Super8K
  501.                         M = MNP Super8K-G
  502.  
  503.               b = Perform  the  transfer  in  Batch  mode.  Note  that both 
  504.                   computers MUST be using SuperK or K9X in  order  for  the 
  505.                   Batch mode to be operational. 
  506.  
  507.               y = SuperK  allows  you to specify if you want overwriting of 
  508.                   existing files to be performed. By including a Y with the 
  509.                   Direction/Protocol  parameter,   the  default   overwrite 
  510.                   setting will be reversed during the current transfer. 
  511.  
  512.           In single file mode,  the J,  X,  C,  W and Y protocols are fully 
  513.           compatible with  their  counterparts  used  on all/most BBS. Both 
  514.           systems must be using SuperK to invoke the  K9Xmodem  or  Super8K 
  515.           Protocols. 
  516.  
  517.           Both  y  and b are optional.  The y overwrite reversal only works 
  518.           in Batch mode (when the b is also present).  If the b is omitted, 
  519.           SuperK defaults to single file mode 
  520.  
  521.   MNP Super8K-G
  522.   ~~~~~~~~~~~~~
  523.           A  brand  new  protocol!!!  As  is the case with the other SuperK 
  524.           protocols,  the new MNP Super8K-G protocol itself may be executed 
  525.           in either Batch (MB parameter) or Single File (M parameter) mode. 
  526.           This  new protocol takes advantage of the MNP error correction of 
  527.           the new high speed (and some lower speed)  modems.  When  called, 
  528.           the  MNP Super8K-G automatically sets the Check-CTS flag and uses 
  529.           the built-in Flow Control code. Also, the Port Locked parameter L 
  530.           is not required.  Along with a much improved throughput,  the MNP 
  531.           Super8K-G  protocol  also rounds file sizes up to the next higher 
  532.           128 byte sector,  ala X/WXmodem,  rather than the next higher  1K 
  533.           byte sector, ala Y/K9Xmodem. 
  534.  
  535.           MNP Super8K-G uses an 8K block and since it IS  NOT  a  windowing 
  536.           protocol  (like  WXmodem and K9Xmodem),  the error/abort response 
  537.           time is improved 1000 fold!  MNP Super8K-G also passes the number 
  538.           of file sectors to the  receiving  system  so  a  file  size  and 
  539.           transfer  time (approxomate) is displayed on both the sending and 
  540.           receiving systems. 
  541.  
  542.           Of course,  the MNP Super8K-G protocol has its own colors  so  be 
  543.           sure to setup SuperK before you use it!
  544.  
  545.           Since MNP Super8K-G only does a byte count update  each  8K,  the 
  546.           tranfer  may seem to be taking a long time...  but in reality.... 
  547.           the following SUPERK.LOG extract displays  the  preliminary  test 
  548.           results  for  each of the SuperK protocols.  These tests were run 
  549.           between two AT's via Null Modem cable.  Results  via  modem  will 
  550.           probably be a little lower accross the board. 
  551.  
  552.             Size    Speed      Cps       Errors   BlkSize   Protocol
  553.           -------------------------------------------------------------
  554.            140414  19200 bps  1526 cps   8 errors   1024    Zmodem Batch
  555.            140416  19200 bps  1902 cps   0 errors   8192    MNP Super8K-G
  556.            147930  19200 bps  1020 cps  48 errors   1024    Zmodem Batch
  557.            147968  19200 bps  1903 cps   0 errors   8192    MNP Super8K-G
  558.  
  559.   Super8K
  560.   ~~~~~~~
  561.           A brand new protocol!!!  As is the case  with  the  other  SuperK 
  562.           protocols,  the Super8K protocol itself may be executed in either 
  563.           Batch (SB parameter) or Single File  (S  parameter)  mode.  Along 
  564.           with a much improved throughput, the Super8K protocol also rounds 
  565.           file sizes up to the next higher 128 byte sector,  ala X/WXmodem, 
  566.           rather than the next higher 1K byte sector, ala Y/K9Xmodem. 
  567.  
  568.           Super8K uses an 8K block with a  1K  error  fallback/restart  and 
  569.           since it IS NOT a windowing protocol (like WXmodem and K9Xmodem), 
  570.           the  error/abort  response  time  is improved 1000 fold!  Super8K 
  571.           also passes the number of file sectors to the receiving system so 
  572.           a file size and transfer time (approxomate) is displayed on  both 
  573.           the sending and receiving systems. 
  574.  
  575.           Of course,  the Super8K protocol has its own colors so be sure to 
  576.           setup SuperK before you use it. 
  577.  
  578.           Since Super8K only does a byte count update each 8K,  the tranfer 
  579.           may  seem  to  be  taking a long time...  but in reality....  the 
  580.           following  SUPERK.LOG  extract  displays  the  preliminary   test 
  581.           results for each of the SuperK protocols and a test comparison to 
  582.           Zmodem  and  Jmodem.  These  tests  were run between two AT's via 
  583.           Null Modem cable.  Results via modem will probably  be  a  little 
  584.           lower accross the board. 
  585.  
  586.             Size    Speed      Cps       Errors   BlkSize    Protocol
  587.           --------------------------------------------------------------
  588.            60800   9600 bps   533 cps  0 errors   0  128   Xmodem   Batch
  589.            60800   9600 bps   769 cps  0 errors   0  128   WXmodem  Batch
  590.            61440   9600 bps   787 cps  0 errors   0 1024   Ymodem   Batch
  591.            61440   9600 bps   869 cps  0 errors   0 1024   K9Xmodem Batch
  592.            60707   9600 bps   861 cps  0 errors   0 1024   Zmodem
  593.            60800   9600 bps   965 cps  0 errors   0 8192   Super8K  Batch
  594.  
  595.            60707   2400 bps   223 cps  0 errors   0 1024   Jmodem
  596.            60707   2400 bps   222 cps  0 errors   0 1024   Zmodem
  597.            60800   2400 bps   262 cps  0 errors   0 8192   Super8K  Batch
  598.           ---------------------------------------------------------------
  599.  
  600.    C   - Perform CTS checking.
  601.  
  602.        This parameter is for those of you who have your comm  ports  locked 
  603.        at  a  higher  baud rate than the actual connection.  If this is the 
  604.        case,  be sure to include this paramater.  The default is for no CTS 
  605.        monitoring. Here's the result of the  ATI5  USR Modem Command"
  606.    
  607.                 USRobotics Courier 9600 HST NRAM Settings....
  608.  
  609.                    DIAL=HUNT   M=0  X=6  F=1  B=0
  610.                    BAUD=19200  PARITY=N  WORDLEN=8
  611.  
  612.                    &A1  &B1  &G0  &H3  &I0  &K0
  613.                    &M4  &N0  &P0  &R2  &S1  &Y1
  614.  
  615.                    S02=043  S03=013  S04=010  S05=008
  616.                    S06=002  S07=030  S08=002  S09=006
  617.                    S10=007  S11=070  S12=050  S13=000
  618.                    S15=000  S19=000  S21=010  S22=017
  619.                    S23=019
  620.  
  621.    L   - Port Locked flag.
  622.  
  623.        In  order  for  the  Super8K protocol to work in locked port setups, 
  624.        SuperK must  disable  its  normal  Xon/Xoff  checking  in  order  to 
  625.        recognize  the  Xon/Xoff  sent  by  the  modem  when it has its port 
  626.        locked.  This command line parameter is provided to let SuperK  know 
  627.        that  the  port  is locked and MUST be present when using an USR HST 
  628.        with the port locked. The default is port is not locked. 
  629.  
  630.    M   - Monitor Carrier,  abort if not present.
  631.  
  632.        Including this parameter allows you to use SuperK to transfer  files 
  633.        between  systems  via  null  modem  cable.  Default  is  ON (Monitor 
  634.        Carrier). 
  635.  
  636.    Nx  - Node Letter or Number. Where x = A to Z  or  0 to 9
  637.  
  638.    E   - The  E parameter toggles the status of the "erase" flag.
  639.  
  640.        If specified on the command line, SuperK will not erase the BATCHLST 
  641.        file it creates when multiple filenames are specified on the command 
  642.        line (until the next time you specify multiple filenames, that is!) 
  643.  
  644.    R   - This Command Line Parameter is for use with RBBS-PC.
  645.  
  646.        RBBS-PC  utilizes  a  true  Batch  download  with a single file mode
  647.        upload.  During uploads, RBBS-PC includes the full path and filename
  648.        for the f paramter.  Since SuperK Batch modes are TRUE Batch in both
  649.        downloads and uploads,  I have added the R command  line  switch  to
  650.        tell  SuperK  that  the  F  parameter  may  (or  may  not) include a
  651.        filename.  When SuperK sees the R parameter,  it will look  for  the
  652.        last  \  or :  characters and parse all characters after that,  thus
  653.        leaving just the path...  which it then appends to any uploads.  The
  654.        default is True (non RBBS-PC) batch uploads.
  655.  
  656.           RBBS command line for Batch Receive using K9Xmodem Batch
  657.  
  658.              SUPERK.COM p[PORT#] s[BAUD] r n[NODE] rkb f [FILE]
  659.  
  660.           RBBS command line for Batch Receive using K9Xmodem Batch
  661.  
  662.              SUPERK.COM p[PORT#] s[BAUD] r n[NODE] skb f [FILE]
  663.  
  664.           example:  RBBS-PC passes [FILE] as  C:\RBBS\99\filename.ext
  665.                     (or your defined upload path) during uploads
  666.  
  667.           exclusion  of the  R  command  line parameter  results in an 
  668.           invalid file specification of 
  669.  
  670.                    C:\RBBS\99\filename.ext\
  671.  
  672.           inclusion of the R command line parameter results in a valid file 
  673.           specification of 
  674.  
  675.                    C:\RBBS\99\
  676.  
  677.           for obvious reasons, if you use the R command line parameter, you 
  678.           must include the last \ or at least one superflous (non  \  or  : 
  679.           character) at the end of the F specification. 
  680.  
  681.           when using the R parameter...
  682.  
  683.             valid     C:\RBBS\99\*.*       results in   C:\RBBS\99\
  684.             valid     C:\RBBS\99\ABC.ZIP   results in   C:\RBBS\99\
  685.             valid     C:\RBBS\99\          results in   C:\RBBS\99\
  686.             invalid   C:\RBBS\99           results in   C:\RBBS\
  687.             no f parameter                 results in   *.*  (all files saved
  688.                                                          in logged drive\dir)
  689.  
  690.           when using the default (non RBBS-PC)
  691.  
  692.             invalid   C:\RBBS\99\*.*       results in   C:\RBBS\99\*.*\
  693.             invalid   C:\RBBS\99\ABC.ZIP   results in   C:\RBBS\99\ABC.ZIP\
  694.             valid     C:\RBBS\99\          results in   C:\RBBS\99\
  695.             valid     C:\RBBS\99           results in   C:\RBBS\99\
  696.             no f parameter                 results in   *.*  (all files saved
  697.                                                          in logged drive\dir)
  698.  
  699.    F   - Filespecs Next
  700.  
  701.        This  parameter  acts  as  a  flag  for  SuperK and denotes that ALL 
  702.        parameters after the F are  to  be  interpreted  as  filenames.  For 
  703.        obvious  reasons,  this  parameter  should be the last one specified 
  704.        (before the filenames)! Each filename may contain a full path in the 
  705.        form: 
  706.                  [d:\path\]Filename [d:\path\]Filename   to send/receive.
  707.  
  708.                                   or
  709.  
  710.        You may also specify the use of a text file  containing  a  list  of 
  711.        filenames.  Each filename in the list may contain a full path.  This 
  712.        option is specified as: 
  713.  
  714.                  @drive:\path\Filelist   (of files to Batch send.
  715.  
  716.                                   or
  717.  
  718.        You may want to use the second option for  file  lists...  that  is, 
  719.        include a second path where ALL of the files within the list reside. 
  720.        This option is specified as: 
  721.  
  722.                  @drive:\path\listfilename@drive:\path 
  723.  
  724.    @   - Default Configuration Mode
  725.  
  726.        Modify colors/logfile name/xferfile name/overlay path/options  flags 
  727.        Clone SUPERK.COM if changes are made 
  728.  
  729.    The port, speed and direction/protocol parameters MUST be supplied... If 
  730.    operating in single file mode, the F parameter must be supplied.  The B, 
  731.    E, U, L, C, Y, M, N and R parameters are optional... and the @ parameter
  732.    is only used to  review/modify  the  default settings  (see modification
  733.    mode below).
  734.  
  735.    The  direction R and S parameters are mutually exclusive (only one,  but 
  736.    not both). 
  737.  
  738.    Command Line parameters may be supplied as upper or lower case,  and may 
  739.    be  entered  in  any  order (except for the F paramter which must be the 
  740.    last one... before any filenames). 
  741.  
  742. SK4.LOG 
  743. ~~~~~~~
  744.    SuperK will record transfer results to  the  logfile  in  the  following 
  745.    format: 
  746.  
  747. +--- Transfer Direction or E for aborted transfer
  748. |  +------- File Size (0 if transfer fails)
  749. |  |      +---------- Modem Speed
  750. |  |      |         +---------- CPS efficiency (0 if transfer fails)
  751. |  |      |         |         +------------- Number of errors
  752. |  |      |         |         |            +-- Dummy for DSZLOG compatability
  753. |  |      |         |         |            | +----- Packet size in bytes
  754. |  |      |         |         |            | |    +--- Filename
  755. |  |      |         |         |            | |    |    Protocol ----++- Batch
  756. |  |      |         |         |            | |    |                 ||
  757. S  27648  1200 bps  108 cps   0 errors     0 1024 C:\DLS\SUPERK.PAK KB
  758.  
  759. XFER.TXT 
  760. ~~~~~~~~
  761.    If  (and  only  if)  a Node character is specified OR a question mark is 
  762.    used within the XferFile name or SuperK Log file name,  SuperK will also 
  763.    create a Xfer Node File to show success/failure status messages. 
  764.  
  765.        This file has the following format :
  766.  
  767.                 Filename
  768.                 Upload   or   Download
  769.                 Protocol      (J/X/C/Y/W/H/K/S/M/JB/XB/CB/YB/WB/HB/KB/SB/MB)
  770.                 Success  or   Fail
  771.                 EOF           (^Z)
  772.  
  773.            Sample:
  774.  
  775.                 SUPERK.ZIP
  776.                 Download
  777.                 KB
  778.                 Success
  779.                 ^Z
  780.  
  781.    The file will be created in the default directory if  no  drive/path  is 
  782.    specified  during the command line @ parameter modification mode.  While 
  783.    in batch mode,  only the first file transfer results will be  logged  to 
  784.    this  file.  However,  SK4.LOG  will  contain  the  results of all files 
  785.    transferred in the batch. 
  786.  
  787. ErrorLevel Exits 
  788. ~~~~~~~~~~~~~~~~
  789.    For ease of use within batch files.. in all cases, SuperK will exit with 
  790.    an ErrorLevel determined by the success of the transfer. 
  791.  
  792.    If  ALL transfers are successful,  SuperK will return an ERRORLEVEL 0 If 
  793.    ANY ONE transfer fails, SuperK will return an ERRORLEVEL 1 
  794.  
  795. Command Line @ Parameter Modification Mode
  796. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  797.    Starting SuperK with the @ command line parameter will put  SuperK  into 
  798.    its  default  modification  mode.  SuperK will first display its current 
  799.    default settings and then prompt you for any changes  you  may  wish  to 
  800.    make.  Note  that  entering  a  blank line (simply hitting [Enter]) will 
  801.    leave the current setting intact.  SuperK  allows  modification  to  the 
  802.    colors it uses,  the logfile name, the xfer file name (for BBS use), the 
  803.    overlay path and certain operational flags. 
  804.  
  805.    C - Modifying colors:
  806.  
  807.        This one's easy!  After selecting the C option,  SuperK will display 
  808.        the  127 color palette that it supports.  Simply select a number for 
  809.        each of the 7  colors  used...  SuperK  will  cycle  through  all  6 
  810.        colors,  updating  the "current settings" accordingly.  If you don't 
  811.        want to change a current color setting,  simply hit the [Enter]  key 
  812.        and  SuperK  will move on to the next setting.  Note:  Jmodem window 
  813.        colors default to black text on a  white  background.  The  7  color 
  814.        types are: 
  815.  
  816.           Xcolors for Xmodem/Xmodem CRC/WXmodem transfers
  817.           Wcolors for WXmodem transfers
  818.           Kcolors for K9Xmodem transfers
  819.           Ycolors for Ymodem transfers
  820.           Scolors for Super8K transfers
  821.           Mcolors for Super8K-G transfers
  822.           Ucolors for universal display of the SuperK logo and batch
  823.                       filenames
  824.  
  825.    D - Logfile Name:
  826.  
  827.        This  is  the  filename  SuperK  uses  to  record the results of any 
  828.        tranfers it performs.  SuperK will accept upto 40 characters so  you 
  829.        may  include  a  full  drive:\path\  along  with  the  logfile name. 
  830.        Additionally,  you may use a question mark (?) as one (and only one) 
  831.        of  the  logfile  name  characters.  If  a question mark is present, 
  832.        SuperK will substitute the Node character in its place.  If no  node 
  833.        character  is  specified,  SuperK  will  use  the letter A as a Node 
  834.        character.  The letter A is substituted ONLY if the question mark is 
  835.        encountered in the logfile name.  If  you  do  not  want  SuperK  to 
  836.        maintain a logfile, simply enter a backslash (\).. which will inform 
  837.        SuperK  to  blank out the logfile name.  The default logfile name is 
  838.        SK4.LOG 
  839.  
  840.    E - XferFile Name:
  841.  
  842.        This is the filename SuperK uses to record transfer results for  use 
  843.        by  BBS  programs.  Its  format and modification is identical to the 
  844.        Logfile Name. The default Xferfile name is XFER.TXT 
  845.  
  846.    F - OvlPath:
  847.  
  848.        Although in most cases,  you will be storing all of the SuperK files 
  849.        in  the  same  directory  as your comm/BBS program files,  there are 
  850.        cases where you may want to store them in a directory other than the 
  851.        logged directory.  This option allows you to do  this.  When  SuperK 
  852.        starts  up,  it  will  use  the  OvlPath  to locate its overlay file 
  853.        (SUPERK.000) and Jmodem module (SKJ.COM).  You must supply the  full 
  854.        drive and path in which the SKJ.COM, SUPERK.COM and SUPERK.000 files 
  855.        reside and all SuperK files MUST reside in this area.  If no OvlPath 
  856.        is  defined,  SuperK  will  expect all of its files to reside in the 
  857.        logged directory.  If, after defining a path,  you decide that it is 
  858.        NOT  required,  simply  enter  a backslash \ for the new path.  This 
  859.        will cause SuperK to null out any existing path.
  860.  
  861.    G - Overwrite:
  862.  
  863.        This  flag  setting  tells  SuperK  whether  or not in can overwrite 
  864.        existing files during Batch mode transfers. The default is NO 
  865.  
  866.    H - Save Aborts:
  867.  
  868.        This flag setting tell SuperK whether or  not  it  should  keep  any 
  869.        partial  files  which were aborted during transfer.  This flag holds 
  870.        for any protocol - batch or single file mode. The default is YES 
  871.  
  872.    I - Write On 0:
  873.  
  874.        This flag setting tells SuperK whether or not it should  create  the 
  875.        XferFile  when  a  transfer  is  not  successfully completed and the 
  876.        uploaded file contains 0 bytes.  The status of this flag is the last 
  877.        check that  SuperK  makes  before  creating  the  XferFile.  A  node 
  878.        character  and XferFile Name must be specified before the Write On 0 
  879.        flag comes into play. The default is YES 
  880.  
  881.    W - Work Path
  882.  
  883.        This  parameter  was  included  in order to supply a simple means of 
  884.        transferring files which have the Read Only attribute set. Since the 
  885.        Turbo Pascal compiler opens all files in a  Read  and  Write  state, 
  886.        SuperK  would experience an I/O error when attempting to open a Read 
  887.        Only file.  Since this problem is more  prevelant  in  a  networking 
  888.        environemnt...  and I didn't particularly care to have to revamp all 
  889.        of the SuperK file  read/write  I/O  routines...  This  option  will 
  890.        circumvent  the compiler problem for those users who wish to use the 
  891.        SuperK driver to send Read Only files. 
  892.  
  893.        By  specifying  a  work path here,  SuperK will create a copy of the 
  894.        requested download in this directory and then proceed  to  send  the 
  895.        copy.  Upon  completion  (or  abort) SuperK will erase the copy.  Of 
  896.        course,  you may use this feature regardless of the File's Read Only 
  897.        Attribute...  if  you  feel  insecure  at  having  SuperK access the 
  898.        "master" file,  set up a work path and SuperK.  If a  work  path  is 
  899.        specified,  it  MUST  be  a  complete path including a drive letter, 
  900.        colon, backspace, directory etc...  upto a maximum of 40 characters. 
  901.        As is the case with the SuperK support files, you may use a question 
  902.        mark  as  a  valid  character  within  the  path  string.  If SuperK 
  903.        encounters a question mark in the Work Path,  it will substitute the 
  904.        node  character  specified  on  the  command  line  or,  if  none is 
  905.        specified, SuperK will substitute an A for the question mark. 
  906.  
  907.        Valid Paths:
  908.  
  909.              Specifed                    Result
  910.  
  911.              C:\BBSWORK                  C:\BBSWORK\filename
  912.  
  913.              C:\NODE?WRK         if no node specified
  914.                                          C:\NODEAWRK\filename
  915.                                  if node 1 specified
  916.                                          C:\NODE1WRK\filename
  917.  
  918.              C:\BBS\NODE?        if no node specified
  919.                                          C:\BBS\NODEA\filename
  920.                                  if node 1 specified
  921.                                          C:\BBS\NODE1\filename
  922.        InValid:
  923.  
  924.              C:\NODE?WRK?        if no node specified
  925.                                          C:\NODEAWRK?\filename
  926.                                  if node 1 specified
  927.                                          C:\NODE1WRK?\filename
  928.  
  929.    [Enter] Quit:
  930.  
  931.        If  you  only wish to view the current default settings,  simply hit 
  932.        [Enter] to exit back to DOS.  If any changes have been made,  SuperK 
  933.        will go into its cloning mode and ask if you want to clone SuperK to 
  934.        preserve  the  new  changes.  Note  that you MUST press the Y key in 
  935.        order to clone SuperK.  Hitting [Enter] here will simply return  you 
  936.        to DOS without saving your changes within the SuperK program. 
  937.  
  938. Program control keys
  939. ~~~~~~~~~~~~~~~~~~~~
  940.    SuperK  will recognize either the [Esc] key or ^X (control X) key during 
  941.    transfers and will abort the current transfer,  returning  you  to  DOS.  
  942.    Note  that  the  streaming  protocols  (Wxmodem,  K9Xmodem)  may require 
  943.    several [Esc] or ^X to abort the transfer and Jmodem/JBatch may  require 
  944.    a ^Break to abort the transfer.
  945.  
  946.    I  have modified the Jmodem module (SKJ.COM) to eliminate as much of the 
  947.    delays as possible... making the batch mode cycling quite "brisk"!  Note 
  948.    however  that there is a delay if the Jmodem transfer is aborted for any 
  949.    reason...  this is due to the fact that the buffers have to be "drained" 
  950.    before recycling. 
  951.  
  952. Batch transfers
  953. ~~~~~~~~~~~~~~~
  954.    SuperK is capable of sending and receiving multiple files in batch mode.  
  955.    Since  this  protocol  driver  was  written  for use with my MiniNet BBS 
  956.    package...  the sending of the file creation date (ala DSZ  and  Telink) 
  957.    tends  to  drive  me  up the wall,  creating quite a bit of confusion in 
  958.    keeeping track of newly acquired files! 
  959.  
  960.    For this reason the major difference between SuperK Batch mode and other 
  961.    Batch modes is that SuperK Batch only sends the File Name and File  size 
  962.    but does not send the file creation date. 
  963.  
  964.    During  Batch  mode  transfers,  SuperK  will  display  the last 3 files 
  965.    requested under the SuperK logo so that you may have a running update of 
  966.    what's happening.  The present transfer progress is displayed in its own 
  967.    window alongside the SuperK logo. 
  968.  
  969.    SuperK is able to handle multiple filenames on  the  command  line.  The 
  970.    command  syntax  remains  the  same  but  if  more  than one filename is 
  971.    specified, SuperK will create its own BATCHLST file. If a Node character 
  972.    is specified on the command line,  that character will be used  for  the 
  973.    extension  of  BATCHLST.  The  default  is  "A"  if no node character is 
  974.    specified. 
  975.  
  976.    The number of filenames that can be specified  will  depend  largely  on 
  977.    your own particular system setup, the string length used by your calling 
  978.    program and the individual filename lengths. 
  979.  
  980.    This   feature  is  only  active  while  in  Batch  Send  Mode  (receive 
  981.    automatically gets filename from sender),  the command  line  paramaters 
  982.    can be in any order,  NO WILDCARDS ARE ALLOWED,  the first filename MUST 
  983.    be preceeded by an F (upper or lower case) and EACH filename may include 
  984.    a full path. 
  985.  
  986.    Your command line should look like this...
  987.  
  988.          SUPERK p1 s9600 SWB f FILE1 FILE2 FILE3
  989.  
  990.    Since the BATCHLST is created internally (by SuperK),  SuperK will erase 
  991.    the  BATCHLST  file once it is done with it...  You may override this by 
  992.    including an E as one of the command line parameters.  The  E  parameter 
  993.    toggles  the  status  of  the "erase" flag.  If specified on the command 
  994.    line,  SuperK will not erase the BATCHLST file (until the next time  you 
  995.    specify multiple filenames, that is!) 
  996.  
  997.    Receiving files in Batch mode
  998.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  999.       You  do  not  have to supply any filename during batch mode receives. 
  1000.       You may of  course,  include  a  full  drive:\path\  in  place  of  a 
  1001.       filename.  Use  the F command line parameter to designate the path in 
  1002.       the form:  f C:\FOO\BAR (with or  without  the  trailing  backslash).  
  1003.       And...  DO  NOT  specify  the  f  parameter if no path or filename is 
  1004.       specified. 
  1005.  
  1006.    Sending files in batch mode
  1007.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~   
  1008.       You  may  use  any  valid  DOS  wildcard  configuration  with  the  F 
  1009.       parameter. 
  1010.  
  1011.       Additionally, you may specify a list of filenames for SuperK to send.  
  1012.       The list filename is specified as 
  1013.        
  1014.               @drive\:path\listfilename
  1015.  
  1016.       You may also specify a full drive:\path\ to where all of the files in 
  1017.       the list reside. This is specified as 
  1018.  
  1019.               @drive:\path\filelist@drive:\path
  1020.  
  1021.       The  filenames  in the list may contain a full drive:\path\ (the same 
  1022.       or different) for each filename. 
  1023.  
  1024.    SuperK is capable of reading and extracting filenames from a standard  - 
  1025.    single  line  - BBS files listing.  If you use a BBS type files listing, 
  1026.    and call SuperK from the comm or BBS directory, you will have to add the 
  1027.    full drive:\path\ to each filename in the list if the files to  send  do 
  1028.    not  reside in the default directory.  There are other ways of accessing 
  1029.    files that reside in directories other than the default (default  upload 
  1030.    and download directories,  etc.),  but I won't go into this area as most 
  1031.    comm and BBS programs do this work for you (K9X does it ALL  for  you... 
  1032.    automatically!) 
  1033.  
  1034. Examples
  1035. ~~~~~~~~
  1036.    1.  Use COM1, 1200 baud, Xmodem, Send files MYFILE.DOC and FILE.COM
  1037.  
  1038.         SUPERK p1 s1200 SX f MYFILE.DOC FILE.COM
  1039.  
  1040.    2.  Use  COM2,  19200  baud,  Ymodem Batch,  Receive file *.DOC,  do not 
  1041.        monitor carrier, override the default "do not overwrite". 
  1042.  
  1043.         SUPERK p2 s19200 m RYBY
  1044.  
  1045.        Note: The  protocol  character  must  follow  the  direction R.  The 
  1046.              second Y above is the override for the overwrite flag.  The  B 
  1047.              and  second Y may be in any order just as long as they are the 
  1048.              third and fourth characters in the Direction parameter. 
  1049.  
  1050.    3.  Use COM1,  9600 baud,  K9Xmodem Batch Send files in MYLIST.LST which 
  1051.        resides  in  my  C:\BBS\  directory.  The files listed in MYLIST.LST 
  1052.        reside in various directories on different drives.  Do  not  monitor 
  1053.        carrier and record success results to Node A of my BBS. 
  1054.  
  1055.         SUPERK p1 s9600 SKB m nA f @C:\BBS\MYLIST.LST
  1056.  
  1057.         C:\BBS\MYLIST.LST looks like this:
  1058.  
  1059.           ABC.ZIP              (this one resides in the default directory)
  1060.           D:\FOO\BAR\MYGAME.EXE
  1061.           E:\LOTUS\123GRAPH.ZIP
  1062.  
  1063.        XFER.TXT (or XFERA.TXT if ?  specified in the default xferfile name) 
  1064.        will reflect the results of the transfer.  Note that only the  first 
  1065.        filename  and  its  transfer  results  will  be present in XFER.TXT.  
  1066.        SUPERK.LOG will however, contain the results of all three files. 
  1067.  
  1068.    4.  Use COM2,  19200 baud,  K9Xmodem Batch Send only files containing an 
  1069.        ZIP extension and residing in my C:\DLS directory, and don't monitor 
  1070.        carrier. 
  1071.  
  1072.         SUPERK p2 s19200 SKB m f C:\DLS\*.ZIP
  1073.  
  1074.    5.  Use COM2,  19200 baud,  K9Xmodem Batch Receive files - store them in 
  1075.        my C:\DLS directory. 
  1076.  
  1077.         SUPERK p2 s19200 RKB f C:\DLS
  1078.  
  1079. Batch Files
  1080. ~~~~~~~~~~~
  1081.    There are sample batch files included in SUPERK.PAK 
  1082.  
  1083.        SEND.BAT  - this batch file is set up for sending file(s) to
  1084.                    another system
  1085.  
  1086.        RECV.BAT  - this batch file is set up to receive file(s) from 
  1087.                    another system
  1088.  
  1089.    Executing any one of the batch files  without  any  parameters  (or  the 
  1090.    wrong  parameter)  will  display  a  short  message  showing the correct 
  1091.    calling procedure and parameter choices.  Since these batch files handle 
  1092.    transfers in either Send or Receive mode and single or batch  mode,  you 
  1093.    will have to supply the proper information in order to have them perform 
  1094.    correctly. 
  1095.  
  1096. NOTE: If you are operating a MiniNet BBS v18.00 or above... or K9X v8.xx or 
  1097.       above...  access to SuperK is handled internally and does not require 
  1098.       the use of the batch files. 
  1099.  
  1100.       If you are not... please read the enclosed PRODUCTS.TXT file...  It's 
  1101.       worth a look! 
  1102.  
  1103.       For pure BBS'ing, K9X can't be beat! 
  1104.  
  1105.  ------------------------------------------------------------------------------
  1106.    I  have  been using this protocol driver on Underdog's MiniNet for quite 
  1107.    some time now.  If you need more information  on  the  various  transfer 
  1108.    protocols,  please  get  a  copy of K9X (my comm program) and review the 
  1109.    K9X.DOC file contained in that package.  All suggestions are  gratefully 
  1110.    received and reviewed! Let me know... 
  1111.  
  1112.  
  1113.                    Sal Manaro  dba  Crater Rim Softare
  1114.                            4028 41st Ave South
  1115.                           Seattle, Wa 98118 USA
  1116.                           (206) 723-6728  voice
  1117.  
  1118.                    Underdog's MiniNet  (206) 725-9233
  1119.                 1200/2400/9600  24hrs  1.2 Gigabytes of Files
  1120.                 Supporting 26 files transfer protocols!
  1121.  
  1122.                            Enjoy,
  1123.                                Sal Manaro
  1124.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1125.  
  1126.   -----------  LET YOUR PRINTER DO ALL THE WORK!  INSTANT MAILER!!!  ---------
  1127.           Please support quality shareware by registering your copies
  1128.                          We thank you for your support!
  1129.  
  1130.   Remit To:  Sal Manaro  dba  Crater Rim Software           SuperK Order Form
  1131.              4028  41st Ave. South
  1132.              Seattle, WA  98118 USA
  1133.  
  1134.   Quantity Discount Schedule (per purchase).  Each:
  1135.  
  1136.      1-10      $25.00        11-49     $23.00         50-99   $20.00
  1137.      100-199   $18.00        200-499   $15.00         500+    $12.00 
  1138.  
  1139.   Please send the ShareWare Evaluation version 4.xx 
  1140.   -------------------------------------------------
  1141.     ____ SuperK Disk(s) without registration ...... @ $ 10.00 ea. $ _______
  1142.  
  1143.   I don't mind the Shareware screen and would like
  1144.   to register the copy I already have:
  1145.   ------------------------------------------------
  1146.     ____ SuperK Registration(s) Only .............. @ $ 20.00 ea. $ _______
  1147.  
  1148.   Please register and send the latest version:
  1149.   -------------------------------------------
  1150.     ____ SuperK Registration(s) and Disk .......... @ $ 25.00  or $ _______
  1151.  
  1152.  
  1153.     PO, Rush and COD orders add $5.00 ........................... $ _______
  1154.  
  1155.                                                         Subtotal    _______
  1156.  
  1157.            (Washington residents please add  8%  sales tax)  Tax    _______
  1158.  
  1159.                                                             Total $ _______
  1160.  
  1161.   Payment by:  ( ) Check    ( ) Money Order    ( ) PO # ___________________
  1162.   Use address on check ( ) or mail to:
  1163.  
  1164.        Name: ______________________________________________________________
  1165.  
  1166.     Company: ______________________________________________________________
  1167.  
  1168.     Address: ______________________________________________________________
  1169.  
  1170.            : ______________________________________________________________
  1171.  
  1172.            : ______________________________________________________________
  1173.  
  1174.   Day Phone: (______)__________________ Eve: (______)______________________
  1175.  
  1176.   ORDERS OUTSIDE USA: Use Check or Money Order drawn on US bank in US dollars
  1177.           -------------------  INSTANT MAILER  ----------------------
  1178.                                                                                 
  1179.   Fold  at  the  page break below with the printing above facing up and the 
  1180.   mailing label below folded underneath.  Staple check to the mailer,  fold 
  1181.   letter  style,  exposing the mailing address and hiding your information. 
  1182.   Fold sides along dotted line and staple or tape sides and top. 
  1183.                                                                                 
  1184.                                                                               
  1185.    |_________________________________                                Place   |
  1186.    |                                                                         |
  1187.    |_________________________________                                Stamp   |
  1188.    |                                                                         |
  1189.    |_________________________________                                Here    |
  1190.    |                                                                         |
  1191.    |                                                                         |
  1192.    |                                                                         |
  1193.    |                                                                         |
  1194.    |                                                                         |
  1195.    |                                                                         |
  1196.    |                                     Crater Rim Software                 |
  1197.    |                                     4028  41st Ave South                |
  1198.    |                                     Seattle WA  98118  USA              |
  1199.    |                                                                         |
  1200.    |                                                                         |
  1201.    |                                                                         |
  1202.    |                                                                         |
  1203.  
  1204.  
  1205.